home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / util / libs / graphics3d.readme < prev    next >
Text File  |  1999-03-02  |  11KB  |  217 lines
  1. Short:    3D graphics shared library V15.00
  2. Author:   p.biancalani@mbox.match.it
  3. Uploader: p.biancalani@mbox.match.it
  4. Type:     util/libs
  5.  
  6. Version        15.00
  7.  
  8. --- English ----
  9. First sorry for my bad English but I don't know it very well.
  10. This is a simple but complete graphic 3D library that use for visualization
  11. only the system library .
  12. Main feature include :
  13.  
  14.    - Visualization of object in systems windows with single buffering.
  15.    - Support of polygons with one, two, tree and four vertex.
  16.    - Use of only fix point value than the math coprocessor is not
  17.      necessary, and is relatively fast on machines us A1200 base too.
  18.    - Implementation of visualization in Wire Frame ,Solid shading ,
  19.      Flat shading and now Goraud shading all simultaneous too and with light 
  20.      source freely placeable .
  21.    - Support of Z-Buffering.
  22.    - Support of Texture mapping with combination of other metod (except of
  23.      wireframe)and support of trasparent color.
  24.    - Add support of virtual color so the color of object is can be indipendent
  25.      from the number of color of the screen, see doc and example for more
  26.      informations.
  27.    - Direct loading of object with a custom format (is present an object converter
  28.      from .plg and .tddd object to this format)
  29.  
  30. Is tested on (for now): 
  31.    A4000/40 with S.O. 3.0
  32.  
  33. Sorry but I have suppressed the 68000 version for problem in linking.
  34. But if any necessed of this its will can be reintegrated. 
  35.  
  36. THIS LIBRARY IS A COPYRIGHT OF THE AUTHOR PATRIZIO BIANCALANI AND IS A 
  37. FREEWARE SOFTWARE THAN FREELY USABLE AND DISTRIBUITE BUT WITH ALL FILE OF 
  38. ORIGINAL ARCHIVE AND NOT FOR RESALE OR IT CAN'T BE SOLD, THAN I PROVIDE 
  39. ABSOLUTELY NO WARRANTY FOR THIS SOFTWARE.
  40. IF YOU WANT MODIFY THE ORIGINAL SOURCES TELL ME THIS THAN ,IF IT IS OK, 
  41. I CAN UPDATE ALL ORIGINAL ARCHIVE.
  42. It is very pleasant if you send me an e-mail if you use it.
  43.  
  44. I have included an example write in E (and full commented) and all the source
  45. in C of this library .The executable is 3dlib and it must be in the same
  46. directory of #?.plg files.It can use more colours with the parameter "256" in the
  47. command string (for machine with almost AGA and S.O. 3.0).
  48.  
  49. The file graphics3d_020_CPU.library is the library for CPU from 68020 with new metod of rendering.
  50. The file graphics3d_020_BLT.library is the library for CPU from 68020 with old metod of rendering.
  51. You must rename the correct library to graphics3d.library before use it.
  52.  
  53. Thanks to:
  54.    Maciej R.Gorny for the original routin of engine 3D.
  55.    Alessandro Franchi for beta testing on A1200.
  56.    VolKer Barthelmann author of VBCC the C compiler used by me to write the
  57.    library.
  58.    Andreas Kleinert author of the optimal startupcode for write shared
  59.    library. 
  60.    Nautilus that have explain to me the algoritm to do goraud shading , z-buffer
  61.    and texture mapping.
  62.    The authors of Tornado3D for the suggetions to implemented the single
  63.    buffering in a window. 
  64.    All ones that have write an e-mail to me.
  65.  
  66. I'am Patrizio Biancalani from Prato (Italy) and the my E-Mail for
  67. suggestions and signaling is :p.biancalani@mbox.match.it
  68.  
  69. Support site :www.amigaworld.com/support/graphics3dlib/welcome.html
  70.  
  71. --- Italiano ---
  72.  
  73. Questa e' una semplice ma completa libreria grafica 3D che si appoggia
  74. interamente sulle librerie di sistema per la visualizzazione.
  75. Le caratteristiche principali sono:
  76.    
  77.    - Visualizzazione oggetti nelle finestre con single buffering.
  78.    - Supporto di poligoni a uno, due, tre e quattro vertici. 
  79.    - Usa valori solo in fix point quindi il coprocessore non serve
  80.      ed e' relativamente veloce anche su macchine come il A1200 base.
  81.    - Implementa la visualizzazione in Wire Frame ,Solid shading, 
  82.      Flat shading ed ora Goraud shading anche tutti contemporaneamente e con 
  83.      la fonte di luce posizionabile a piacere.
  84.    - Supporto dello Z-Buffering.
  85.    - Supporto del Texture mapping in combinazione con gli altri metodi (ad
  86.      eccezione del wireframe) e supporto del colore trasparente.
  87.    - Aggiunto il supporto dei colori virtuali cosi' che il colore degli oggetti
  88.      oggetti sia indipendente dal numero di colori dello schermo.
  89.      Per maggiori informazioni vedi l'esempio e la documentazione.
  90.    - Supporta il caricamento di oggetti in formato propietario.(E' presente un 
  91.      convertitore da oggetti .plg e .tddd verso tale formato).
  92.  
  93. E' stata testata su(per ora):
  94.    A4000/40 con S.O. 3.0
  95.  
  96. Spiacente ma il supporto del 68000 e' stato soppresso per problemi nel linkaggio.
  97. Ma se fosse necessario a qualcuno posso sempre cercare di reintegrarlo.
  98.  
  99. QUESTA LIBRERIA E' UN COPYRIGHT DELL'AUTORE PATRIZIO BIANCALANI ED E' UN
  100. FREEWARE SOFTWARE QUINDI LIBERAMENTE DISTRIBUIBILE MA CON TUTTI I FILE
  101. DELL'ARCHIVIO ORIGINALE E NON PER FINI DI LUCRO, IO NON FORNISCO 
  102. ASSOLUTAMENTE ALCUNA GARANZIA SU QUESTO SOFTWARE.
  103. SE VOLETE MODIFICARE I SORGENTI ORIGINALI COMUNICATEMELO, SE E' ACCETTABILE
  104. IO AGGIORNERO' L'ARCHIVIO ORIGINALE.
  105. E' molto gradita la ricezione di un e-mail in caso di uso della libreria. 
  106.  
  107. Ho incluso anche un esempio di uso scritto in E e i sorgenti in C della
  108. libreria.L'eseguibile si chiama 3dlib e deve essere nella stessa directory
  109. dei file #?.plg .Se si da il parametro "256" nella stringa di comando si potranno
  110. usare piu' colori (solo per macchine con almeno l'AGA e il S.O. 3.0). 
  111.  
  112. Il file graphics3d_020_CPU.library e' per le CPU dal 68020 con nuovo metodo di visualizzazione.
  113. Il file graphics3d_020_BLT.library e' per le CPU dal 68020 con vecchio metodo di visualizzazione.
  114. Occorre rinominare la corretta libreria in graphics3d.library prima di
  115. usarla.
  116.  
  117. Si ringrazia :
  118.    Maciej R.Gorny per le routin del motore 3D.
  119.    Alessandro Franchi per il parziale beta testing su A1200.
  120.    VolKer Barthelmann autore del compilatore C VBCC da me usato per
  121.    la stesura della libreria.
  122.    Andreas Kleinert autore dell'ottimo startupcode per le shared
  123.    library. 
  124.    Nautilus che mi ha spiegato l'algoritmo per il goraud shading , lo z-buffer
  125.    e il texture mapping.
  126.    Gli autori di Tornado3D per il suggerimento su come implementare 
  127.    il single buffering in una finestra.
  128.    Tutti quelli che mi hanno scritto.
  129.  
  130. Io sono Patrizio Biancalani residente a Prato Italy e il mio E-Mail per
  131. suggerimenti e segnalazioni e': p.biancalani@mbox.match.it
  132.  
  133. Sito di supporto :www.amigaworld.com/support/graphics3dlib/welcome.html
  134.  
  135.  
  136. ============================= Archive contents =============================
  137.  
  138. Original  Packed Ratio    Date     Time    Name
  139. -------- ------- ----- --------- --------  -------------
  140.    15228    6450 57.6% 23-Jan-99 09:46:40 +3dlib
  141.      625     148 76.3% 20-Dec-98 11:32:36 +assi.3dgfo
  142.      465     155 66.6% 21-Jan-99 18:46:12 +assi.plg
  143.   132732   24990 81.1% 21-Dec-98 13:03:22 +chair.tddd
  144.    14816    5943 59.8% 23-Jan-99 09:46:56 +conv
  145.      342     101 70.4% 06-Jan-99 11:29:58 +cube.3dgfo
  146.      602     237 60.6% 21-Jan-99 18:46:10 +cube.plg
  147.     1797     666 62.9% 22-Jan-99 18:54:54 +graphics3D.fd
  148.     3550    1502 57.6% 23-Jan-99 09:30:42 +graphics3D.i
  149.     1797     666 62.9% 22-Jan-99 18:54:54 +graphics3D.fd
  150.     4027    1547 61.5% 23-Jan-99 09:30:14 +graphics3D_pubblic.h
  151.     2516     945 62.4% 22-Jan-99 19:21:28 +graphics3D_stub.lib
  152.      812     368 54.6% 22-Jan-99 18:54:54 +graphics3Dbase.h
  153.      739     345 53.3% 23-Jan-99 09:41:02 +graphics3D.m
  154.      840     418 50.2% 23-Jan-99 09:41:04 +graphics3D_lib.m
  155.    21851    5918 72.9% 21-Jan-99 23:47:52 +graphics3D.h
  156.    11399    3649 67.9% 21-Dec-98 12:34:50 +graphics3D.h.doc
  157.     2946    1373 53.3% 21-Jan-99 18:46:16 +graphics3d.history
  158.     1394    1083 22.3% 26-Feb-98 23:35:00 +graphics3d.history.info
  159.     4726    1949 58.7% 22-Jan-99 00:12:50 +graphics3d.notes
  160.     1394    1084 22.2% 27-Feb-98 23:39:42 +graphics3d.notes.info
  161.    56789   14254 74.9% 21-Jan-99 19:20:10 +graphics3d_E.doc
  162.     1154     757 34.4% 27-Feb-98 23:35:52 +graphics3d_E.doc.info
  163.    76299   15638 79.5% 21-Jan-99 23:53:30 +graphics3D_E.guide
  164.     1611     755 53.1% 26-Feb-98 23:31:42 +graphics3d_E.guide.info
  165.    59604   15080 74.6% 21-Jan-99 19:17:24 +graphics3d_I.doc
  166.     1154     757 34.4% 27-Feb-98 23:35:44 +graphics3d_I.doc.info
  167.    79202   16613 79.0% 21-Jan-99 23:56:30 +graphics3d_I.guide
  168.     1611     755 53.1% 26-Feb-98 23:31:42 +graphics3d_I.guide.info
  169.     6351    2860 54.9% 21-Jan-99 19:35:32 +graphics3d.readme
  170.    32688   17635 46.0% 22-Jan-99 19:21:26 +graphics3d_020_BLT.library
  171.    37916   20066 47.0% 22-Jan-99 19:34:46 +graphics3d_020_CPU.library
  172.     5912    1497 74.6% 10-Jan-99 23:52:22 +prova.iff
  173.      236      87 63.1% 06-Jan-99 11:30:12 +pyramid.3dgfo
  174.      944     418 55.7% 21-Dec-98 09:48:24 +pyramid.plg
  175.    34829    8483 75.6% 17-Jan-99 12:38:08 +sfera.3dgfo
  176.    30984    8132 73.7% 21-Dec-98 09:48:22 +sfera.plg
  177.    22149    6285 71.6% 22-Jan-99 18:55:20 +conv.e
  178.    12035    4044 66.3% 23-Jan-99 09:46:00 +3dlib.h
  179.    12092    4122 65.9% 22-Jan-99 18:54:42 +3dlibdemo.e
  180.     1125     603 46.4% 22-Jan-99 18:54:42 +3dlibh.h
  181.      129     102 20.9% 17-Oct-98 12:41:12 +compila
  182.    16336    4355 73.3% 28-Jan-98 21:27:22 +gad.h
  183.     2389     863 63.8% 13-Apr-97 09:58:52 +gen.h
  184.      739     345 53.3% 23-Jan-99 09:41:02 +graphics3D.m
  185.      840     418 50.2% 23-Jan-99 09:41:04 +graphics3D_lib.m
  186.      598     323 45.9% 22-Jan-99 18:55:10 +debuglib.c
  187.      269     152 43.4% 22-Jan-99 18:55:10 +debuglib.h
  188.     1797     666 62.9% 22-Jan-99 18:54:54 +graphics3D.fd
  189.    15252    4753 68.8% 23-Jan-99 09:29:58 +graphics3D.h
  190.     3550    1502 57.6% 23-Jan-99 09:30:42 +graphics3D.i
  191.     5950    1682 71.7% 22-Jan-99 18:54:56 +graphics3D.make
  192.    16323    4690 71.2% 22-Jan-99 18:54:56 +graphics3D2d.c
  193.     1017     350 65.5% 22-Jan-99 18:54:56 +graphics3D2d.h
  194.    26264    6974 73.4% 22-Jan-99 18:54:54 +graphics3d2d_o.c
  195.      443     225 49.2% 22-Jan-99 18:55:04 +graphics3d2d_o.h
  196.      976     362 62.9% 16-Jan-99 16:14:04 +graphics3D2d_proto.h
  197.      812     368 54.6% 22-Jan-99 18:54:54 +graphics3Dbase.h
  198.      791     367 53.6% 22-Jan-99 18:54:54 +graphics3Dc.h
  199.    37637   10046 73.3% 22-Jan-99 18:54:54 +graphics3Df.c
  200.     4819     960 80.0% 22-Jan-99 18:54:54 +graphics3Df.h
  201.    29735    8559 71.2% 22-Jan-99 18:55:10 +graphics3df1.c
  202.    13337    4237 68.2% 22-Jan-99 18:55:06 +graphics3df_g.c
  203.    19553    5044 74.2% 22-Jan-99 18:54:54 +graphics3Df_i.c
  204.     9326    2309 75.2% 22-Jan-99 18:54:56 +graphics3Df_i2.c
  205.     4442     946 78.7% 22-Jan-99 18:54:54 +graphics3Df_proto.h
  206.    11482    2539 77.8% 22-Jan-99 18:54:54 +graphics3Df_t.c
  207.     5079    1861 63.3% 22-Jan-99 18:55:06 +graphics3dl.c
  208.      298     210 29.5% 22-Jan-99 18:55:08 +graphics3dl.h
  209.      291     205 29.5% 22-Jan-99 18:55:06 +graphics3dl_proto.h
  210.     6553    2088 68.1% 22-Jan-99 18:54:56 +graphics3Dli.c
  211.      926     326 64.7% 22-Jan-99 18:54:58 +graphics3dm.c
  212.     2601     594 77.1% 22-Jan-99 18:54:58 +graphics3dm.s
  213.      607     352 42.0% 22-Jan-99 18:54:58 +graphics3Dm68k.c
  214.     8523    2218 73.9% 22-Jan-99 18:54:54 +graphics3Dsu.c
  215. -------- ------- ----- --------- --------
  216.   948967  269369 71.6% 26-Jan-99 18:13:54   75 files
  217.